home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / dbase / vision51.zip / #_VISION.DB < prev    next >
Text File  |  1992-10-05  |  80KB  |  1 lines

  1.                                 VISION   SYSTEM                                                              =================                                                            (v 5.1 01-Oct-1992)                                                                   by                                                                    Maurizio  Ammannato                                                       (R) 1992  Maurizio's House                                                                                                                                                                                      Welcome to VISION System                                                      ========================                                                      Vision  is  a  Free  Form Textual Data Base System. The first access method isthe  usual  hierarchical  Chapter/Pages two-levels access. In this way you canread  newspaper  articles,  documents,  books,  dictionaries, glossaries, helpfiles  ,etc.)  just  choosing  the Data Base you want read (first layer), thenits  Chapters  (second layer), finally the chapter Pages (third layer). Or youcan  access  a  VISION  Data  Base using HypertText technique, thus navigatingtext  through  its  key-words  (fourth layer). This package allow you to buildyour own Text Data Base by yourself. It isn't not just a "Read Only" package.                                                                                                                                                             Licence Fee                                                                   ===========                                                                   The  package  is completely free of charge for personal use. Do as many copiesyou  like  for you and your friends. However you don't have to sell it or makeany  kind  of  profit.  Any  commercial  use of VISION must be agreed with theAuthor.                                                                                                                                                                                                                                                                                                                 MY PREFERRED SENTENCE                                                         =====================                                                         "It's  hard  to  believe  that  good people are still the Silent Engine of theWorld  as  it is to believe that under the dirty sea surface a large and cleanworld  really  exists.  Unfortunately  this  Appearance  bombs  constantly oursenses; fortunately it is a very small part of the Entire."                                                                            (Oiziruam Otannamma)                                                                                                                                                                                                                                                                                                                         Enjoy VISION System !                                                                                                                                                                                                Maurizio Ammannato                                                             Via Preguda N.60                                                            22049 Valmadrera (CO)                                                         ---------------------                                                               I T A L Y       Decompressing Archives                                                        ======================                                                        Create  a  directory  called VISION (DOS command MD) and copy there VISION.ZIPfile  and  eventually  all  related  Textual Data Base with the extension .ZIP(which means compressed via PKZIP.EXE utility).                                                                                                             Using  the  companion  PKUNZIP.EXE  utility  (which  you can find on many BBS)decompress them as following :                                                                                                                                                                                                                                        C:\VISION\pkunzip *.zip                                                                                                                                                                                       In this way all .ZIP archives will be 'unzipped'.                                                                                                                                                                                         The VISION package must have the following files :                                                                                                                                                                                        - VISION.EXE             engine program                                       - VIS_OVL.EXE            its overlay                                          - VIS_CRE.EXE            create your own Textual Data Base (import)           - VIS_UPD.EXE            from .DB database back to .UPD ASCII file (export)   - VIS_SORT.EXE           sort utility                                         - VIS_FONT.EXE           change VGA screen text font                          - VISION.CFG             configuration file (default=color)                   - VISION.COL             configuration file for color monitor                 - VISION.BW              configuration file for mono monitor                  - VISION.MSG             comment/help file for VISION.EXE (default=English)   - VIS_OVL.MSG            comment/help file for VIS_OVL.EXE (default=English)  - VISION.ENG             VISION.EXE comment file in English                   - VIS_OVL.ENG            VIS_OVL.EXE comment file in English                  - VISION.ITA             VISION.EXE comment file in Italian                   - VIS_OVL.ITA            VIS_OVL.EXE comment file in Italian                  - VISION.DOC             VISION documentation in printable format (English)   - #_VISION.NDX           documentation in VISION format (INDEX)               - #_VISION.DB            documentation in VISION format (DB)                  - WHATIS.NEW             brief description of new features                                                                                                  Demo files:                                                                                                                                                 - VISION.DDD             example file for VISION.DIR option                   - #_PIPPO.UPD            example source file to build new VISION DB           - #_PLUTO.UPD            example source file to build new VISION DB with                               HyperText facility                                                                                                                                                                                                                                                                             Decompress  all  .ZIP Textual Data Bases (TDB) you have in the directory usingthe  same  procedure  as  before;  after that copy all .ZIP files in a back-updevice and REMOVE all .ZIP (i.e. "ERASE *.ZIP") to save precious disk space.  VISION Configuration                                                          ====================                                                          Check  through  your  favorite  Text  Editor  or  WP  the  configuration  fileVISION.CFG and change what you need or wish to change.                                                                                                                                                                                    Foreground  color numbers can range from 1 to 31 (after number 15 the color isblinking). Background from 1 to 7.                                            The following is the complete list of options you can set :                                                                                                                                                                                                                                                             '---------------------------------- VISION.CFG config file                    SCROLL_SPEED=7     number of secs for automatic scrolling                     SORT=BYNAME        or BYDATE or NO sort option                                EDITOR=filename    full path of your preferred Text Editor (Alt-E)            WDW_END=@@@        break-characters for Keyword Windows                       SKD_LFT=60         source keyword left delimiting character                   SKD_RGT=62         source keyword right delimiting character                  TKD_LFT=17         target keyword left delimiting character                   TKG_RGT=16         target keyword right delimiting character                  F_DBW=15           foreground Data Base Window (DBW) color                    B_DBW=7            background Data Base Window (DBW) color                    F_BOT=0            foreground Help Desk color                                 B_BOT=2                                                                       F_COM=0            foreground DBW comment line                                F_HIG=14           foreground DBW data base name                              F_DBR=10           foreground DBW highlighted DB name                         B_DBR=1            background DBW highlighted DB name                         F_IDX=15           foreground Index Window (IW) color                         B_IDX=1                                                                       F_TDX=7            foreground IW text color                                   B_TDX=1                                                                       F_DOC=0            foreground Document Text color                             B_DOC=7                                                                       F_REV=0            foreground reverse Index title                             B_REV=6                                                                       F_ASK=15           input window                                               B_ASK=4                                                                       F_FND=14           founded string color                                       Color or Monochrome                                                           ===================                                                           You can easily change color attributes modifying .CFG file color parameters.                                                                                To  make  your  life  easier,  if  you have a monochrome screen, copy directlyVISION.BW to VISION.CFG file using DOS COPY command:                                                                                                                                                                                                            C:\VISION\COPY vision.bw vision.cfg                     VISION.MSG Message file                                                       =======================                                                       Edit  also  VISION.MSG  messages  file  and change what you need (i.e. from myItalian English to Queen's English, etc.)                                                                                                                   To change language file use COPY DOS command :                                                                                                                                                                                                                 C:\VISION\COPY vision.ita vision.msg                                                                                                                                                                                 to   have   the   Italian  comments/help.  You  can  obviously  create  a  newcomment/help file with your own language; i.e. for Spanish :                                                                                                - copy VISION.ENG into a new file VISION.ESP (DOS "COPY                         VISION.ENG VISION.ESP")                                                                                                                                   - modify the new file with Spanish translation using a TE or                    WP (Text Editor or Word Processor)                                                                                                                        - copy new VISION.ESP into VISION.MSG (c:\vision\COPY VISION.ESP VISION.MSG)                                                                                                                                                                                                                                                                                                                                ==================================================================            New comment strings MUST MUST have the same LENGTH of the old ones            ==================================================================      Executing VISION                                                              ================                                                              Before  executing VISION for the first time, verify to have available at leastone  TDB  (Textual  Data Base) with both .DB and .NDX files. You must at leasthave  VISION  files.  You  can  create  a  new  one by yourself (see below) ordownload  some  from a BBS. Remember to decompress them if ZIPped as explainedbefore.                                                                                                                                                                                                                                   You have two different ways to execute VISION.                                                                                                              1)  MENU  MODE.  Typing  VISION at DOS prompt, you enter into Main Menu Windowwith the list of available Data Bases (see below):                                                                                                                                         C:\VISION>vision                                                                                                                                                                                           2)  COMMAND  LINE  MODE.  Typing VISION followed by data base name at DOS lineprompt,  you  enter directly into Index Menu from which, using ESCape command,you come back directly to DOS :                                                                                                                                                         C:\VISION>vision b_netw                                                                                                                                                                                                                                                                     If  you  have  a  VGA  monitor  you  can  execute vision typing VGA instead ofVISION.  This  allows  VISION  to  load into PC ROM a new text font (modern-d)resulting in a more readable text:                                                                                                                                                           C:\VISION>vga                                                                                                                                                                                                                                                                          Also  in  this  case  you  can  enter directly into the Index Menu writing VGAfollowed by data base name:                                                                                                                                                             C:\VISION>vga #_vision                                                                                                          to have on line VISION documentation.                                         VISION Data Base Structure                                                    ==========================                                                    Before  going  on  it's  a good idea to define the Textual Data Base structureused by VISION.                                                                                                                                                                                                                                                 **********************************                                            A VISION Data Base has FOUR layers                                            **********************************                                                                                                                                                                                  1) Data Base Layer (list of all available Data Bases names, up to 100)        2) Title Layer     (list of all Data Base Titles, no limit)                   3) Page Layer      (text pages of selected Title, no limit)                   4) Keyword Layer   (window text on selected word, no limit for keyword                            number, 16 windows in depth for each keyword)                                                                                                                                                                         Two examples                                                                  ------------                                                                                                                                                #_VISION Data Base:                                                           . Name, comment, creation date and size => Data Base LAYER (1st)              . Chapter titles                        => Title LAYER (2nd)                  . Vision document Pages                 => Page LAYER (3rd)                                                                                                 N_GLOSSA Data Base:                                                           . Name, comment, creation date and size => Data Base LAYER (1st)              . Glossary Terms                        => Title LAYER (2nd)                  . Term Description                      => Page LAYER (3rd)                   . Keyword Comment                       => Keyword LAYER (4th)                Main Menu Window                                                              ================                                                              In  the  Main Menu, you can see at the same time up to 15 available Data Baseswith  related  comment,  last update data and size. The limit of available TDBis 100 Data Base. Press Alt-H keys to get an on line help.                                                                                                                         ********************************                                              Alt-H to get VISION on line HELP                                              ********************************                                                                                                                                                                                                      Help - MAIN MENU Available Commands (1st)                                     =========================================                                                                                                    Alt-B  Build New Data Base                     PgDn  Page Down                Alt-C  Change Data Base Comment Line           PgUp  Page Up                  Alt-D  Delete Data Base                             Title Up                 Alt-E  Edit Source ASCII file (.UPD)                Title Down               Alt-R  Restore Original Index                  Home  Top of List              Alt-S  Sort Title Index Ascending              End   Bottom of List           Alt-T  Sort Title Index Descending             ─┘   Open Data Base           Alt-U  Rebuild ASCII UPD file (EXPORT)         ESC   Exit                                                                                                                                                                                                                                                           Use  Up/Down  arrows or PgUp/PgDn to navigate, Alt-H for on-line help. Once onthe  line of chosen DB (highlighted color) the ENTER key allow you to open theTitle Menu (you enter into 2nd layer).                                                                                                                                          ***************************************                                       ENTER key to OPEN highlighted Data Base                                       ***************************************                                                                                                                                                                               Initially  TDB  Titles  are  indexed  sequentially  (first record found, firstrecord  in  DB).  You  have two possibilities to change the indexing method bypressing  ALT-S  or  ALT-T  keys.  These  two  commands  tell  VISION  to sorthighlighted  index  by  alphabetical  ascending  (ALT-S) or descending (ALT-T)order.                                                                                                                                                                        *******************************************                                   Alt-S Alt-T to index differently Title list                                   *******************************************                                                                                                                                                                              Any way Alt-R option restores the original indexing method.                                                                                                                   *****************************************                                     Alt-R to RESTORE original indexing Method                                     *****************************************                                                                                                                                                                              From  Main  Menu  you  can directly edit a new/old VISION source .UPD file. Touse  this option you have to declare before, in VISION.CFG file, the preferredText  Editor FULL PATH and EXTENSION. Then, non depending on which highlightedname  you  are,  press  together Alt-E keys and give the filename WITHOUT .UPDextension.  If  you  use  an editor called QEDIT, in \EDITORS\ directory on D:device, write in your VISION.CFG the following path:                                                                                                        ...........................                                                   EDITOR=D:\EDITORS\QEDIT.EXE                                                   ...........................                                                                                                                                                      ************************************                                          Alt-E to EDIT source ASCII .UPD file                                          ************************************                                                                                                                                                                                 From  Main  Menu  you  can  also  directly  build  a new VISION Data Base. Nondepending  on  which  highlighted  name you are, press together Alt-B keys andgive  the  New data base name WITHOUT .UPD extension (you must have this ASCIIfile on VISION directory).                                                                                                                                                      **************************************                                        Alt-B to CREATE new Data Base (IMPORT)                                        **************************************                                                                                                                                                                                You  can also rebuild the original .UPD ASCII file from main Menu, 1) move thebar  on  the  Data  Base  name  then  2)  press  Alt-U.  You  are required forconfirmation.                                                                                                                                                                 ******************************************                                    Alt-U to REBUILD source .UPD file (EXPORT)                                    ******************************************                                                                                                                                                                              To  delete  an  existing Data Base, move the bar up to selected Data Base nameand  press Alt-D keys. Before removing highlighted Data Base, you are requiredto  confirm that. This command DOESN'T cancel the related .UPD source file butonly .DB, .NDX and .KEY files.                                                                                                                                                   *************************************                                         Alt-D to DELETE highlighted Data Base                                         *************************************                    Title Window                                                                  ============                                                                  Once on TITLE Window, press Alt-H keys to get the following on line Help :                                                                                                                                                                                   Help - TITLE WINDOW Available Commands (2nd)                                  ============================================                                                                                                 PgDn/Up Page Down/Up                /       Title Up/Down                   Alt-H   This Help                   Home/End  Top/Bottom List                 F1      Search String               F9        Search String Globally          F2      Search Again                F10       Global Search Again             ─┘     Open Document               ESC       Exit                                                                                                                                                                                    Use Up/Dn arrows and PgUp/PgDn keys to navigate this list.                                                                                                  If  you  have  a  long list you can use F1 key to quickly search the title youneed,  F2  to  search  again.  You  can  search also for a piece of word, i.e."etw".  In this case all words having "etw" will be displayed. F2 search againusing same search string.                                                                                                                                                    *********************************************                                 F1/F2 keys to SEARCH a word in the Title list                                 *********************************************                                                                                                                                                                            Using  F9/F10  you search instead for words line per line across documents. Anexample.  Let  imagine  you  want  to  search  the  word "disciple" in the NewTestament.                                                                                                                                                  1) be in New Testament index window (Title level)                             2) press F9 and give search string "disciple"                                 3) VISION finds search string in a book title                                 4) enter in the book (ENTER key)                                              5) press F2 to search same string inside the document                         6) press ESC to come back to Index window                                     7) press F10 to search again at book title level (index)                                                                                                    The  difference  between two above searching methods is that F1/F2 keys searchthe  string  within  the  index  comment line (Index level), while F9/F10 keyssearch the string in the entire Data Base.                                                                                                                               ****************************************************                          F9/F10 keys to SEARCH a word in the ENTIRE Data Base                          ****************************************************                                                                                                                                                                                                                                                       Opening Document                                                              ----------------                                                              Move  bar  up  to  desired  title,  then  press  the ENTER key to open relateddocument.                                                                                                                                                                       **************************************                                        ENTER key to OPEN highlighted Document                                        **************************************                    Document Window                                                               ===============                                                               Once in Document window press Alt-H keys to get the following help:                                                                                                            Help - DOCUMENT Window Available Commands (3rd)                               ===============================================                                                                                              Alt-A  Automatic Scroll On/Off       PgDn/Up   Page Down/Up                   Alt-F  Write Document to File        /       Line Up/Down                   Alt-M  Mark Document Position        Home/End  To/Bottom List                 Alt-J  Jump to Mark (Alt-M)          -/+       Dec/Incr Scroll Speed          Alt-P  Print Document                F1        Search String                  -/-  Keyword Navigation            F2        Search Again                   ─┘    Open Keyword                  ESC       Exit                                                                                                                                                                                   Up/Down  arrows,  PgUp/PgDown  and Home/End keys allow you to quickly navigateacross Document Window.                                                                                                                                                   **************************************************                            Up/Down,PgUp/PgDown,Home/End to navigate DOCUMENTS                            **************************************************                                                                                                                                                                          While Left/Right arrows let you navigate through keywords (if they exist)                                                                                                                                                                                     **************************************                                        Left/Right Arrows to navigate KEYWORDS                                        **************************************                                                                                                                                                                                                                                                                                                                                            Reading Long Document                                                         =====================                                                         Reading  long  document  you  need  some  functions  to  emulate the real bookreading.                                                                                                                                                                                                                                  The  first  one  is to mark a position for latter retrieve. Use Alt-M when youwant  stop  reading  at  a  specific position (a soft beep advises you of workdone).  Once  you are back to same document use Alt-J to jump to mark. With nomark, Alt-J jumps to first document line.                                                                                                                               ******************************************************                        Alt-M and Alt-J to MARK a position for later retrieval                        ******************************************************                                                                                                                                                                        If  you want to read document without using arrows for navigation, you can usethe  Alt-A  automatic  scroll  option. VISION has a default value of 7 secondsdelay  time  between  scrolling (see in VISION.CFG the SCROLL_SPEED option) sothat you can read it relaxed and quite.                                                                                                                     Use  plus  key  (+)  to slow down scrolling speed or minus (-) key to increasesuch a speed.                                                                 Keyword Window                                                                ===============                                                               Once in the a Keyword Window, press Alt-H keys to get following Help:                                                                                                                                                                                        Help - MAIN Window Available Commands                                         =====================================                                                                                                        -/-  Keyword Navigation                         Alt-H    This Help          ─┘    Open Keyword                               ESC      Exit                                                                                                                                                                                                                                                     Because  in  a  Keyword  Window  you  can  find other keywords, use Left/Rightarrows  to  navigate these new keywords. You can have up to 16 Keyword Windowsin depth.                                                                                                                                                              ********************************************************                      Up to 16 Keyword Windows in depth for each DOCUMENT word                      ********************************************************                                                                                                                                                                                                                                                                                                                                   How Many Keyword Windows                                                      ------------------------                                                      When  at document level (3rd layer), each word can be a keyword. If a documenthas  for  example  1000  words,  you can have at the maximum 1000 keywords forthis  level.  Once  open  one  of  these  1000  keyword, you enter FIRST LEVELKeyword  Window where you can find other keywords (in a Keyword Window you canfind  about a maximum of 100 words). Then you can choice one of them and enterin  the  SECOND LEVEL Keyword Window, and that up to 16 LEVELS Keyword Windowsin depth.                                                                                                                                                                                                                                 If  we  have  for  example  a Data Base with 100 documents, each document with1000  words and assume that each of them are a keyword, and each of them opensa  FIRST  level  window with about 100 keywords per window, up to 16 LEVELS indepth,  the  maximum number of Keywords Windows we can have for that Data Baseis the following :                                                                                                                                                                                                                                                  100x1000x100x16=16,000,000                          VISION Data Base Technical Structure                                          ====================================                                          VISION  System  works  using  two  different  files,  the index file with .NDXextension  and  data  base  file  with  .DB  extension. If Data Base uses alsokeyword option, VISION creates in this case a third file with .KEY extension.                                                                                                                                                             The following is its structure :                                                                                                                            1) Index record title (78 bytes 78 character)                                 2) Physical DB address (2 bytes integer)                                      3) Length of document  (4 bytes long integer)                                 4) Position of the Mark (2 bytes integer)                                     5) Reserved for later use (2 bytes integer)                                                                                                                                                                                               The Data Base structure is very simple :                                                                                                                    1) Comment line (78 bytes 78 characters)                                                                                                                                                                                                  But  you  have  to  don't care at all of this technical info, you have only tofollow these very simple instructions to create your new data base.           Creating New Free Form Textual Data Base                                      ========================================                                                                                                                                                                                                  A) Building New Source ASCII File                                             ---------------------------------                                             Take  your  favorite  Text Editor or use Alt-E option from Main Menu to edit anew  source  file  called  i.e. #_PIPPO.UPD (the .UPD extension is a MUST) andwrite your info in the following order :                                                                                                                    1) First row will become FIRST index record                                                                                                                 2)  from  second  line up to the special break-characters line, write documentlines  with  a  maximum  of  78  characters  (pay attention to don't write thefollowing special combination of characters '@#$' at the line beginning).                                                                                   3)  special break-string combination to close the document; that is a '@#$' atthe beginning of the line.                                                                                                                                  Look at the following simple #_PIPPO.UPD example :                                                                                                                                                                                                           ---beg of file----- (don't insert this line in your file)  NETWORK                                                                       ========                                                                      The network is....                                                            ..................                                                            ..................                                                            [@#$]              (Don't write these squared brackets in real file)          SUPER-CENTER                                                                  ============                                                                  The supercenters are....................................                      ........................................................                      ........................................................                      ........................................................                      ........................................................                      ........................................................                      [@#$]              (Don't write these squared brackets in real file)          PROTOCOLS                                                                     =========                                                                     You need protocols when you                                                   have to exchange information with other people/computers.                     The language is one of above protocols.                                                          ---end of file----- (don't insert this line in your file)                                                                                                                                                                        **********************************************************                    DON'T insert the break-string at the BEGINNING of the file                    **********************************************************                                                                                                     ****************************************************                          DON'T insert the break-string at the END of the file                          ****************************************************                                                                                                     ***********************************************************                   DON'T put BLANK lines between break-string and FIRST record                   ***********************************************************                                                                                                                                                                     B) Creating VISION format Data Base                                           -----------------------------------                                           Once  done  this  ASCII  test  file, on VISION Main Menu, press Alt-B keys andgive  its filename without any extension. This file MUST reside in same VISIONdirectory.                                                                                                                                                              ******************************************************                        .UPD source files MUST be in the same VISION directory                        ******************************************************                                                                                                                                                                        You  can  also  use  VIS_CRE program at DOS level without entering VISION MainMenu :                                                                                                                                                                                 C:\VISION\vis_cre #_pippo                                                                                                                                                                                      This  program  creates  #_PIPPO.NDX  with three master records (NETWORK,SUPER-CENTER,PROTOCOL) and the #_PIPPO.DB data base with text.                                                                                                                                                                                  After  VISION has created these two files, it asks for a DB comment line. (Youcan  also  change  this  comment  later,  on  Main  Menu  press  Alt-C keys onhighlighted name).                                                                                                                                                                                                                                                                                                      See  and  use  this  example  to understand how to build or to modify a sourceASCII  .UPD  file.  #_PIPPO.UPD  must  be  in  the VISION delivery disk or ZIParchivie.                                                                                                                                                             ***********************************************************                   USE #_PIPPO.UPD file to understand how to build a VISION DB                   ***********************************************************         New Data Base from existing ASCII File                                        ======================================                                        This  procedure  is  the most common use of VISION because you have often some.DOC/.MAN/.TXT/.HLP  files  in printable or listable ASCII format and you wantto  transform  them in the more readable VISION format. VISION can very easilytransform this ASCII files in a Textual Free Form Data Base.                                                                                                           ********************************************************                      VISION can quickly transform ASCII files in FREE FORM DB                      ********************************************************                                                                                                                                                                                                                                                     A) Modifying Source ASCII File                                                ------------------------------                                                Take  the ASCII file you want to convert and rename it with the .UPD extension(i.e.  PIPPO.DOC  in  #_PIPPO.UPD);  remove  all extraneous lines (top of formcharacter,  page  break, etc.) and do exactly the same procedure as to build anew VISION source .UPD file.                                                                                                                                                                                                                                                                                            Example of #_PIPPO.UPD ASCII file to convert                                  ------------------------------------------                                                                                                                                                                                                                         - Pag 1 -                                                                                                                          NETWORK                                                                       ========                                                                      The network is....                                                            ..................                                                            ..................                                                                                                                                          TOF (Top of Form printer command)                                                                                                                                                    - Pag 2 -                                                                                                                          SUPER-CENTER                                                                  ============                                                                  The supercenters are....................................                      ........................................................                      ........................................................                      ........................................................                      ........................................................                      ........................................................                                                                                                    TOF (Top Of Form printer command)                                                                                                                                                    - Pag 3 -                                                                                                                          PROTOCOLS                                                                     =========                                                                     You need protocols when you                                                   have to exchange information with other people/computers.                     The language is one of above protocols.                                                                                                                                                                                                   Now  remove  ALL  EXTRANEOUS  lines,  i.e.  the  "Pag  nn"  lines,  the  "TOF"characters,  the  blank  not  useful  lines, then follow the same procedure asbefore  to  create  new  source file so that the original PIPPO.DOC looks likethe following #_PIPPO.UPD file :                                                                                                                                                                                                                             ---beg of file----- (don't insert this line in your file)  NETWORK                                                                       ========                                                                      The network is....                                                            ..................                                                            ..................                                                            [@#$]              (Don't write these squared brackets in real file)          SUPER-CENTER                                                                  ============                                                                  The supercenters are....................................                      ........................................................                      ........................................................                      ........................................................                      ........................................................                      ........................................................                      [@#$]              (Don't write these squared brackets in real file)          PROTOCOLS                                                                     =========                                                                     You need protocols when you                                                   have to exchange information with other people/computers.                     The language is one of above protocols.                                                          ---end of file----- (don't insert this line in your file)                                                                                                                                                                                                                                            Once  PIPPO.DOC  has  been modified in this #_PIPPO.UPD way, enter VISION Mainmenu and press Alt-B keys to generate new DB.                                 Updating an Existing Data Base                                                ==============================                                                The best way to update a VISION DB is to :                                                                                                                  1) enter VISION Main Menu (1st level)                                         2) move the bar to Data Base name                                             3) press Alt-U keys and confirm                                                                                                                             Now VISION creates again original .UPD source file, then :                                                                                                  4) exit VISION (ESC key)                                                      5) use your preferred Text Editor to UPDATE source .UPD file                  6) enter again VISION                                                         7) Alt-B keys to update VISION Data Base (.DB, .NDX and eventually .KEY)                                                                                    or with Alt-E option :                                                                                                                                      4) Alt-E to edit .UPD just created source file                                5) Alt-B keys to update VISION Data Base (.DB, .NDX and eventually .KEY)      Erasing Data Base                                                             =================                                                             Enter  VISION  Main  Menu,  move  bar on Data Base to remove, then press Alt-Dkeys.  VISION  removes  only  .DB,  .NDX and .KEY files; it doesn't delete the.UPD source ASCII file.                                                       Sort Option                                                                   ===========                                                                   You  can  have  the list of available TDB (Textual Data Bases) sorted in threedifferent ways (first Menu Window).                                                                                                                         Write in VISION.CFG file your sorting choice.                                                                                                               SORT=BYNAME        It sorts Data Bases by names.                              SORT=BYDATE        It sorts Data Bases by date (last equal first)             SORT=NO            VISION doesn't make any sort.                                                                                                            Using  SORT=NO  and  VISION.DIR  option,  you  can decide by yourself the DataBases order (thus you get in main Window the exact order of VISION.DIR file). Changing the Main Menu List                                                   ===========================                                                   Renaming  BOTH  files  (.NDX  and .DB file) with a name of your choice, VISIONsorts  automatically  them  by  new  alphabetical  order  putting  them in theposition you prefer (if the sorting option is set on BYNAME).                                                                                                                                                                             For example :                                                                                                                                               N_......  = network related data bases                                        P_......  = product related data bases                                        S_......  = services                                                          V_......  = various and generic data base                                     $_......  = pricing data bases                                                ..  = ...............................                                                                                                                                                                                                                                                                                   Simply  changing the name of your DB (and related .NDX and .KEY file), you geta  different  classification. For example if you want to put #_PIPPO Data Basein  first Main Menu line, execute the following DOS command, at DOS prompt, inthe VISION directory :                                                                                                                                                           C:\VISION\rename #_pippo.* !_PIPPO.*                                                                                                   to be sure to change all #_PIPPO DB related files.                            Directory Option                                                              ================                                                              When  VISION starts, it firstly look for a file called VISION.DIR. So that youhave two different VISION behavior :                                                                                                                        1) VISION doesn't find it in current directory.                                  Then VISION looks for files on current directory as usual.                                                                                               2) VISION finds this file. Then it uploads DBs into Main Menu following          VISION.DIR directive.                                                                                                                                    In  the  last  way you can have your VISION files anywhere in your PC. Look atthe example for a better understanding.                                                                                                                            *****************************************************************             Using VISION.DIR option you can have DB files ANYWHERE in your PC             *****************************************************************                                                                                                                                                                                                                                                VISION.DIR example                                                            ==================                                                            D:\VISION\#_VISION   (.DB .NDX and .KEY files on current dir)                 C:\BIBLE\B_NEWT      (.DB .NDX and .KEY files on C:,in \BIBLE\ dir)           G:\V_PRESS           (.DB .NDX and .KEY files on G:\, optical disk)                                                                                                     *******************************************************                       YOU MUST GIVE THE FULL PATH (DEVICE,DIRECTORY and NAME)                       *******************************************************                                                                                                                                                                       You  have  to  build  that  VISION.DIR  file using your preferred text editor.VISION.DIR  must  reside in the same VISION programs directory. Give a look toVISION.DDD, an example file in the distribution disk.                                                                                                                                                                                     When  you  load  a new data base, remember to update VISION.DIR file otherwisethe program will ignore it.                                                                                                                                               **************************************************                            REMEMBER to UPDATE VISION.DIR when adding a new DB                            **************************************************              To Create Hypertext Document                                                  ============================                                                  To build document in HyperText way you have to remember three main things :                                                                                 1) how to declare a SOURCE keyword                                            2) how to mark a TARGET keyword                                               3) how to write a Keyword WINDOW                                                                                                                                                                                                                                                                                        HyperText Parameters in VISION.CFG                                            ----------------------------------                                            Give  a  look  at  VISION.CFG file (TYPE it or use a Text Editor). You have tofind the following parameters:                                                                                                                              WDW_EWND=@@@       this means you declare this three characters as the                           break-string to let VISION understand where a Keyword                         Window text stops.                                                                                                                       SKD_LFT=60         source keyword left delimiting character                   SKD_RGT=62         source keyword right delimiting character                                     these characters delimit the text word you want be                            a text keyword                                                                                                                           TKD_LFT=17         target keyword left delimiting character                   TKG_RGT=16         target keyword right delimiting character                                     for each SOURCE keyword you have to declare a TARGET                          keyword using these two delimiting characters                                                                                                                                                                          Now  an  example. Let's imagine to have the example as before (#_PIPPO.UPD) towhich we want add HyperText facility. Call this new file #_PLUTO.UPD.                                                                                                        *********************************************                                 See #_PLUTO.UPD file for an Hypertext Example                                 *********************************************                                                                                                                                                                                               ---beg of file----- (don't insert this line in your file)  NETWORK                                                                       ========                                                                      The <network> is....(here "network" is the 1st SOURCE keyword)                ..............................................................                ..............................................................                [@#$]              (Don't write these squared brackets in real file)          SUPER-CENTER                                                                  ============                                                                  The <supercenters> are............ (2nd SOURCE keyword)                       .......................................................                       .......................................................                       .......................................................                       .......................................................                       .......................................................                       [@#$]              (Don't write these squared brackets in real file)          PROTOCOLS                                                                     =========                                                                     You need <protocols> when you  (3rd SOURCE keyword)                           have to exchange information with other people/computers.                     The <language> is one of above protocols. (4th SOURCE keyword)                [@#$]              (Don't write these squared brackets in real file)          Hypertext Notes                                                               ---------------                                                               network          (1st TARGET keyword)                                       With Network word we intend here a Telecommunication Network.                 Also called <VAN>.                                                            [@@@]              (Don't write these squared brackets in real file)          supercenters                                                                A Supercenter has clusters of processors, hundreds of disk devices.           For this reason we use to call them Supercenter.                              [@@@]              (Don't write these squared brackets in real file)          protocols                                                                   See <protocol>                                                                [@@@]              (Don't write these squared brackets in real file)          language                                                                    Usually  in Information Technology we use to call language a source high levelgroup of rules to be translated in machine sequence of binary symbols.        [@@@]              (Don't write these squared brackets in real file)          VAN                                                                         It  stands for Value Added Network. Differs from carrier because of some addedfeatures like a protocol conversion, etc.                                     [@@@]              (Don't write these squared brackets in real file)          protocol                                                                    It's a group of rules to let participants to understand each other.                              ---end of file----- (don't insert this line in your file)                                                                                                                                                              We  have  declared  network  as  the first SOURCE keyword. We've enclosed thisword  between  "<"  (decimal 60 as in CONFIG.SYS in SKD_LFT parameter) and ">"(decimal  62  as  in  SKD_RGT). Now we have to put somewhere the correspondingTARGET keyword. You can change in CONFIG.SYS these delimiting characters.                                                                                                ****************************************************                          For each SOURCE keyword a TARGET keyword MUST exists                          ****************************************************                                                                                                                                                                         In  #_PLUTO.UPD  example  we've  put  at  documents  end a new document called"Hypertext  Notes"  where  we  can  write  all  Hypertext  TARGET keywords andrelated texts.                                                                                                                                              We  have  here  to declare first TARGET text (in this case the word "network")and  we  have  to enclose it between a "" decimal 17 (as in VISION.CFG in theTKD_LFT  parameter)  and a "" decimal 16 (as in TKD_RGT parameter). Obviouslyyou can change these two characters in VISION.CFG.                                                                                                          After  TARGET  keyword  declaration  we  have to write below an explanation ofthis  keyword  with following limits : no more than 78 characters per line, nomore than 20 lines per comment.                                                                                                                                           ***************************************************                           KEYWORD WINDOWS limits are 78 characters x 20 lines                           ***************************************************                                                                                                                                                                         After  text  end  write three "@@@" (as in VISION.CFG in WDW_END parameter) tolet VISION understand where text stops.                                                                                                                                  ****************************************************                          DON'T insert the break-string at the END of the file                          ****************************************************             Attention to break-string                                                     =========================                                                     When  you  are  using  HyperText capability, pay attention to the break-stringcharacters  of  HyperText  texts (usually three "@@@", decimal 64, declared inVISION.CFG  in  the  WDW_END=xxx  option),  different  from  the  break-stringcharacters  for  VISION  texts  (they MUST be ALWAYS "@#$", dec 64, dec 35 anddec 36).                                                                                                                                                    You  have  the  option  to  change  the  HyperText  break-string  to  get moreflexibility  in  designing  you  HyperText structure. In fact in the "glossarydocument"  case  you  need  to  have  each  VISION text be at the same time anHyperText  text  too. In this case, declare the same VISION break-string (thus"@#$")  in  WDW_END=xxx  parameter  in  VISION.CFG  file, for HyperText break-characters.                                                                                                                                                        ****************************************************************                Every time you're building a new doc with HyperText function                VERIFY the break-string value on VISION.CFG in WDW_END parameter              ****************************************************************                                                                                     VISION Commamnd Line                                                          ====================                                                          You can execute VISION also from another program capable to SHELL to DOS.                                                                                   To  do  that  you  have  only  to  execute  VISION  in command line mode, thusVISION.EXE followed by data base name:                                                                                                                                                 C:\VISION\VISION #_pippo                           Changing Text Font                                                            ==================                                                            If  you  have a VGA monitor, you can change the ROM standard PC font. You haveto  execute before VISION a small utility VIS_FONT which loads a modern-d font(use firstly VIS_FONT /D option) into PC ROM.                                                                                                                                                                                             You  can change the font using instead of /d the /s "scrawled" hand made font,or /l or no option for modern-s font.                                         PC Configuration                                                              ================                                                              You need any MS-DOS compatible Personal Computer with :                                                                                                     - at least 256 k Bytes of main memory                                         - hard disk                                                                   - video                                                                                                                                                     better if :                                                                                                                                                 - 640 K bytes of main memory                                                  - VGA color video (the reading is easier)                                     History                                                                       =======                                                                                                                                                             4.1        - Added VIS_UPD.EXE to revert VISION Data Bases into                            the original ASCII .UPD file.                                                                                                                             - Fixed a bug while printing documents from a very large                        Data base.                                                                                                                                                                                                                   4.2        - Fixed minor bug in main menu window when DBs are exactly                      14 files.                                                                                                                                                                                                                    4.4        - 15 Data Base names on Main Menu instead of 14.                                20 text rows on Text Windows instead of previous 19.                                                                                                      - No more RAM option.                                                                                                                                       - No more SOUND option.                                                                                                                                     - Added Data Base name SORT option.                                                                                                                         - Slightly faster than 4.2 version.                                                                                                                                                                                            5.0        - Partially rewritten and recompiled used P.D.Q library                         to have a complete assembler code. Much smaller than                          before and faster.                                                                                                                                        - Added Hypertext Capability.                                                                                                                               - Removed Alt-D shell to DOS.                                                                                                                               - Added Alt-B to create new DB directly from Main Menu.                                                                                                     - Added Alt-E to edit source ASCII .UPD file.                                                                                                               - Added Alt-U to rebuild original source .UPD file.                                                                                                         - Added Alt-D to erase a DB from Main Menu.                                                                                                                 - Each of four layers has each Help screen.